CD Ware Multimedia 1995 May

home *** CD-ROM | disk | FTP | other *** search

/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / DOS / PRGMMING / PBVL110.ZIP / PBVLITE.DOC < prev next >

Wrap

Text File | 1994-11-10 | 112.2 KB | 2,642 lines

THERE IS NO NEED TO PRINT THIS ENTIRE DOCUMENT, The entire PB/VISION(tm) LITE reference manual can be accessed directly through PowerBASIC's built-in help system. Copy PBVLITE.PBH in the same directory as PB.EXE and then press CTRL-F1 until the PB/VISION(tm) index appears. ┌───────────────────────────────────────────────────────┐ │ │ │ P B / V I S I O N (tm) L I T E │ │ Visual Windowing Library for PowerBASIC 3.0 │ │ SHAREWARE EVALUATION VERSION │ │ │ │ Documentation │ │ │ │ (c) Copyright 1993-94 DSE Software Publishing │ │ Licensed Material. All Rights Reserved. │ │ │ │ ┌────────────────────────────────────┐ │ │ │ ▀▀▀▀▀▀▀▀\ ▀▀▀▀▀▀\ ▀▀▀▀▀▀▀▀▀▀\ │ │ │ │ ▀▀▀\ ▀\ ▀▀\ ▀▀\ ▀▀▀\ ▀▀\ │ │ │ │ ▀▀▀\ ▀\ ▀▀\ ▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀\ ▀▀▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀▀\ ▀▀▀▀▀▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀▀\ ▀▀\ ▀▀▀\ │ │ │ │ ▀▀▀\ ▀\ ▀\ ▀▀\ ▀▀▀\ ▀\ │ │ │ │ ▀▀▀\ ▀\ ▀▀\ ▀▀\ ▀▀▀\ ▀▀\ │ │ │ │ ▀▀▀▀▀▀▀▀\ ▀▀▀▀▀▀\ ▀▀▀▀▀▀▀▀▀▀\ │ │ │ └────────────────────────────────────┘ │ │ │ │ DSE Software Publishing │ │ Post Office Box 96 │ │ Willits, CA 95490-0096 │ │ (707) 459-4358 │ │ FAX: (707) 459-4484 │ │ │ │ InterNet: dse.software@genie.geis.com │ │ DSE Online! BBS - (707) 459-4484 │ │ GEnie: DSE.SOFTWARE │ │ │ └───────────────────────────────────────────────────────┘ PowerBASIC is a registered trademark of PowerBASIC, Inc. PB/VISION(tm) and PB/WORKSHOP(tm) are trademarks of DSE Software Publishing. Other product names are trademarks or registered trademarks of their respective holders. Contents Information for Users . . . . . . . . . . . . . . 2 Warranty . . . . . . . . . . . . . . . . . . . . 2 License for Use and Distribution . . . . . . . . 2 Installation . . . . . . . . . . . . . . . . . . . 3 Technical Support . . . . . . . . . . . . . . . . 3 Chapter 1 WINDOW MANAGEMENT ROUTINES 5 App - VARIABLE . . . . . . . . . . . . . . . . . . 5 AppClose - PROCEDURE . . . . . . . . . . . . . . . 5 AppFontInit - PROCEDURE . . . . . . . . . . . . . 6 AppInit - PROCEDURE . . . . . . . . . . . . . . . 6 AppPause - PROCEDURE . . . . . . . . . . . . . . . 6 AppRefresh - PROCEDURE . . . . . . . . . . . . . . 7 AppResume - PROCEDURE . . . . . . . . . . . . . . 7 AppTitle - PROCEDURE . . . . . . . . . . . . . . . 7 Attr% - FUNCTION . . . . . . . . . . . . . . . . . 8 MapChar - PROCEDURE . . . . . . . . . . . . . . . 8 MapUserChar - PROCEDURE . . . . . . . . . . . . . 9 WinTitle - PROCEDURE . . . . . . . . . . . . . . . 9 WinClose - PROCEDURE . . . . . . . . . . . . . . . 9 WinCls - PROCEDURE . . . . . . . . . . . . . . . 10 WinColor - PROCEDURE . . . . . . . . . . . . . . 10 WinCopy% - FUNCTION . . . . . . . . . . . . . . 11 WinDeleteLine - PROCEDURE . . . . . . . . . . . 11 WinDrawBox - PROCEDURE . . . . . . . . . . . . . 11 WinFill - PROCEDURE . . . . . . . . . . . . . . 12 WinGet - FUNCTION . . . . . . . . . . . . . . . 12 WinGetCursor - PROCEDURE . . . . . . . . . . . . 13 WinGetInfo - PROCEDURE . . . . . . . . . . . . . 13 WinHide - PROCEDURE . . . . . . . . . . . . . . 14 WinHotPrint - PROCEDURE . . . . . . . . . . . . 14 WinInsertLine - PROCEDURE . . . . . . . . . . . 15 WinInstallCode - PROCEDURE . . . . . . . . . . . 15 WinLocate - PROCEDURE . . . . . . . . . . . . . 15 WinLock - PROCEDURE . . . . . . . . . . . . . . 16 WinLockAll - PROCEDURE . . . . . . . . . . . . . 16 WinLockState% - FUNCTION . . . . . . . . . . . . 17 WinLockRestore - PROCEDURE . . . . . . . . . . . 17 WinMain - PROCEDURE . . . . . . . . . . . . . . 17 WinMaximize - PROCEDURE . . . . . . . . . . . . 18 WinMinimize - PROCEDURE . . . . . . . . . . . . 18 WinNormalize - PROCEDURE . . . . . . . . . . . . 19 WinModify - PROCEDURE . . . . . . . . . . . . . 19 WinMove - PROCEDURE . . . . . . . . . . . . . . 20 i WinNext - PROCEDURE . . . . . . . . . . . . . . 20 WinOpen% - FUNCTION . . . . . . . . . . . . . . 20 WinPopup% - FUNCTION . . . . . . . . . . . . . . 22 WinPrev - PROCEDURE . . . . . . . . . . . . . . 22 WinPrint - PROCEDURE . . . . . . . . . . . . . . 23 WinReColor - PROCEDURE . . . . . . . . . . . . . 23 WinRefresh - PROCEDURE . . . . . . . . . . . . . 23 WinRefreshMode - PROCEDURE . . . . . . . . . . . 24 WInResize - PROCEDURE . . . . . . . . . . . . . 24 WinScrollBarGet - PROCEDURE . . . . . . . . . . 25 WinScrollBarSet - PROCEDURE . . . . . . . . . . 25 WinShow - PROCEDURE . . . . . . . . . . . . . . 26 WinSwapColor - PROCEDURE . . . . . . . . . . . . 26 WinViewPort - PROCEDURE . . . . . . . . . . . . 27 WinWrite - PROCEDURE . . . . . . . . . . . . . . 27 WinWriteChar - PROCEDURE . . . . . . . . . . . . 27 WinWriteLn - PROCEDURE . . . . . . . . . . . . . 28 Chapter 2 EVENT MANAGEMENT ROUTINES 29 GetEvent% - FUNCTION . . . . . . . . . . . . . . 29 HotKeyAdd - PROCEDURE . . . . . . . . . . . . . 30 HotKeyToggle - PROCEDURE . . . . . . . . . . . . 31 TimerInstallCode - PROCEDURE . . . . . . . . . . 31 WinCtrlBox - PROCEDURE . . . . . . . . . . . . . 32 Chapter 3 MOUSE ROUTINES 33 Mouse% - FUNCTION . . . . . . . . . . . . . . . 33 MouseCursorOff - PROCEDURE . . . . . . . . . . . 34 MouseCursorOn - PROCEDURE . . . . . . . . . . . 34 MouseGet% - FUNCTION . . . . . . . . . . . . . . 34 MouseGetInfo - PROCEDURE . . . . . . . . . . . . 35 MouseGetPress% - FUNCTION . . . . . . . . . . . 35 MouseGetRelease% - FUNCTION . . . . . . . . . . 36 MouseInit% - FUNCTION . . . . . . . . . . . . . 37 MouseSet - PROCEDURE . . . . . . . . . . . . . . 37 MouseSetWindow - PROCEDURE . . . . . . . . . . . 38 MouseTerm - PROCEDURE . . . . . . . . . . . . . 38 Chapter 4 DATA TYPES USED 39 MENUCOLORTYPE - TYPE . . . . . . . . . . . . . . 39 WINTYPE - TYPE . . . . . . . . . . . . . . . . . 39 Index 41 ii PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Information for Users ───────────────────────────────────────────────────────────────── PB/VISION(tm) LITE is a shareware program. This evaluation version includes all features of the program, and is not crippled in any way. You may use it for up to 30 days, without charge (see ORDER_ME.TXT for more details). If you like the program, and wish to continue its use after this evaluation period, you are required to pay for the program (see ORDER_ME.TXT for more details). Any fee you may have paid to others (disk vendors, dealers, etc.) to obtain this evaluation version was a fee for their copying and distribution services, rather than a payment for continued use of the program. Warranty ───────────────────────────────────────────────────────────────── LIMITED WARRANTY THIS SOFTWARE AND MANUAL ARE PROVIDED FOR EVALUATION ONLY, ON AN "AS IS" BASIS. DSE SOFTWARE PUBLISHING DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NEITHER DSE SOFTWARE PUBLISHING NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF DSE SOFTWARE PUBLISHING HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. This agreement shall be governed by the laws of the State of California and shall inure to the benefit of DSE Software Publishing and any successors, administrators, heirs and assigns. Any action or proceeding brought by either party against the other arising out of or related to this agreement shall be brought only in a STATE or FEDERAL COURT of competent jurisdiction located in Mendocino County, CA. The parties hereby consent to in personam jurisdiction of said courts. License for Use and Distribution ───────────────────────────────────────────────────────────────── TRIAL USE LICENSE PB/VISION(tm) LITE is NOT a public domain program. It is copyrighted by DSE Software Publishing. This software and accompanying documentation are protected by United States copyright law and also by international treaty provisions. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 2 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ DSE Software Publishing grants you a limited license to use this software for evaluation purposes for a period not to exceed thirty days. If you continue using this software after the thirty-day evaluation period, you MUST make a registration payment to DSE Software Publishing. You may not use, copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed program except as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license. All rights not expressly granted here are reserved to DSE Software Publishing. Installation ───────────────────────────────────────────────────────────────── The installation procedure for PB/VISION(tm) LITE is quite simple. Simply copy all of the included files into either your PowerBASIC directory. You may also place it in an entirely different directory if that is your choice. In either case, you will need about 650k of available disk space on the hard drive on which you plan to install PB/VISION(tm) LITE. It is _very_ important that you place PBVLITE.PBH in the same directory as the PowerBASIC IDE (PB.EXE). This will allow you to access the entire PB/VISION(tm) LITE documentation directly through PowerBASIC's built-in help system. While in PB.EXE, to bring up our help screens, place the cursor on a keyword and press <CTRL-F1>. To then bring up the index to all of the PB/VISION(tm) routines. YOU'RE READY TO GO Once you've completed the installation, you should consult TUTORIAL.DOC. That file will tell you how to use all of the PB/VISION(tm) features, and will give you other information you need to properly evaluate PB/VISION(tm) LITE. We hope you enjoy the program. Technical Support ───────────────────────────────────────────────────────────────── If you have any problems, please read this file, HELPME!.DOC, and TUTORIAL.DOC first. If you still have a question and need assistance, help is available from the following sources: 1. DSE Online! BBS at 707-459-4484. 24 hours @ 1200-14.4K. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 3 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 2. GEnie: address messages to "DSE.SOFTWARE". Do not send us x-modem mail on GEnie. We will not accept the file and your account will be billed for it. 3. InterNet: "dse.software@genie.geis.com" 4. CompuServe: "INTERNET:dse.software@genie.geis.com" 5. If you have an urgent problem that cannot wait, you may call the DSE Technical Support Department at (707) 459-4358 from 10:00 AM to 5:00 PM. Calls outside these hours will not be answered. Please have the following information ready before calling: a. Computer brand, model, and the brands and mode numbers of any additional hardware. b. Operating system and version number. (The version number can be determined by typing VER at the DOS prompt.) c. Contents of your AUTOEXEC.BAT file. d. Contents of your CONFIG.SYS file. e. You will have to have read TUTORIAL.DOC. Our help staff may quiz you ;) ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 4 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Chapter 1 WINDOW MANAGEMENT ROUTINES █████████████████████████████████████████████████████████████████ App - VARIABLE ───────────────────────────────────────────────────────────────── PURPOSE: Defines PB/VISION start-up display parameters. REMARKS: This variable has the following element(s): Element Description ──────────────── ──────────────────────────────────── App.attr Color of background fill-pattern. App.flags Application initialization flags. App.graphicsMode 0=text, 1=graphics. App.graphicsMouse 0=text mouse, 1=graphical mouse. App.menuAttr Color of menu bar (if enabled). App.Pattern Screen fill-pattern (0 = none). App.rows Number of lines to use on screen. Value Description ───── ────────────────────────────── 0 Use default size. 25 25 lines (all systems). 28 28 lines (VGA Only). 30 30 lines (VGA Only). 43 43 lines (EGA, VGA). 50 50 lines (EGA, VGA). App.statusAttr Color of status bar (if enabled). App.title See APPTITLE() routine. App.titleAttr Color of program title (if enabled). Use the APP type variable to define how the display will look when APPINIT() is called. The APP.flags element allows for one or more of the following flags: APP.flag Description ───────────── ──────────────────────────────────── %MENUBAR Make room for a menu bar. %STATUSBAR Make room for a status bar. SEE ALSO: APPINIT, APPTITLE AppClose - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Shuts down all aspects of PB/VISION. SYNTAX: APPCLOSE ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 5 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ REMARKS: Use APPCLOSE() prior to ending a program. When called, APPCLOSE() hides and closes all open windows and restores the contents of default window 1 to the screen. SEE ALSO: APPINIT AppFontInit - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Refreshes graphics mapped character set. SYNTAX: APPFONTINIT REMARKS: Use APPFONTINIT() to re-initialize PB/VISION's graphics mapped character set. It may be necessary to call this routine if a background application or TSR corrupts the character set. SEE ALSO: APPINIT AppInit - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Initialize all aspects of PB/VISION(tm). SYNTAX: APPINIT REMARKS: Use APPINIT() to initialize PB/VISION(tm) with the definitions defined in the APP type variable. APPINIT() automatically stores the entire display contents and copies it into a predefined virtual with a window handle of 1. SEE ALSO: APPCLOSE, APPREFRESH, APPTITLE AppPause - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Temporarily shuts down PB/VISION. SYNTAX: APPPAUSE REMARKS: Use APPPAUSE() to temporarily shut down the windowing system and restore the contents of default window 1 to the screen. This command should be called prior using BASIC's "SHELL" command or switching to a graphics mode. SEE ALSO: APPINIT, APPRESUME ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 6 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ AppRefresh - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Rebuilds the entire display. SYNTAX: APPREFRESH REMARKS: Use APPREFRESH() to rebuild the screen if it becomes corrupted by errant PRINT statements and such. SEE ALSO: APPINIT AppResume - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Restarts PB/VISION after a call to APPPAUSE(). SYNTAX: APPRESUME REMARKS: Use APPRESUME() to restart the windowing system after a previuos call to APPPAUSE(). The desktop and all open windows are restored to their original state. APPRESUME() does not restore the status bar or pulldown menu. If either of these options are used, you must immediately follow the call with calls to STATUSSHOW() and/or PULLMENUSHOW(). SEE ALSO: APPINIT, APPPAUSE AppTitle - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Adds or changes a desktop title. SYNTAX: APPTITLE kolor%, title$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── kolor% Color of desktop title. title$ Text of the title. Use APPTITLE() to add or change the title displayed on the top line of the application desktop. The title is automatically centered. SEE ALSO: APP, APPINIT ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 7 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Attr% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Returns a calculated color combination code SYNTAX: varname% = ATTR%(fore%, back%) REMARKS: This function accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── fore% Foreground attribute ranging 0-15. back% Background attribute ranging 0-15. Use ATTR% to create an integer attribute to pass to procedures such as WINPRINT(). The supplied foreground and background attributes are identical to the attributes in BASIC's COLOR statement. SEE ALSO: WINCOLOR, WINOPEN, WINPRINT NOTE: READ THE TUTORIAL. THERE IS A MUCH BETTER METHOD. MapChar - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Maps a PB/VISION icon into an ASCII character. SYNTAX: MAPCHAR char%, icon% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── char% ASCII character to map. icon% Graphics mapped icon to map. Icon # Description ────── ──────────────────────────────── 1 F1 icon. 2 F2 icon. 3 F3 icon. 4 F4 icon. 5 F5 icon. 6 F6 icon. 7 F7 icon. 8 F8 icon. 9 F9 icon. 10 F10 icon. 11 Hourglass icon. 12 Double stacked boxes. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 8 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Use MAPCHAR() to map a PB/VISION graphics mapped icon into an ASCII character. If you modify APP.ROWS during execution of a program, you must re-call this routine. SEE ALSO: APPFONTINIT, MAPUSERCHAR MapUserChar - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Maps a user-defined icon into an ASCII character. SYNTAX: MAPUSERCHAR char%, icon$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── char% ASCII character to map. icon$ Bit-mapped string icon to map. Use MAPUSERCHAR() to create a custom user-defined graphics mapped icon (re-define the ASCII character set). If you you modify APP.ROWS during execution of a program, you must re-call this routine. SEE ALSO: APPFONTINIT, MAPCHAR WinTitle - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Adds or changes the title in a window. SYNTAX: WINTITLE winHandle%, kolor%, title$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window. kolor% Color of window title. title$ Text of the title. Use WINTITLE() to add or change the title of an open window. SEE ALSO: WINOPEN, WINPOPUP WinClose - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Closes a previously opened window. SYNTAX: WINCLOSE winHandle% ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 9 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. Use WINCLOSE() to close a previously opened window. All memory used by the window is returned to the PowerBASIC heap and all assigned code is removed from the event manager. SEE ALSO: WINHIDE, WINOPEN, WINSHOW WinCls - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Perform a "clear screen" on an open window. SYNTAX: WINCLS winHandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. Use WINCLS() to clear out the contents of an open window. Subsequent calls to WINWRITE(), WINWRITECHAR(), or WINWRITELN() will start at the top left corner of the window. If WINCOLOR() has been called, the window will be cleared to the specified color. SEE ALSO: WINCOLOR, WINWRITE, WINWRITECHAR, WINWRITELN WinColor - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Sets the color for subsequent window print commands. SYNTAX: WINCOLOR winHandle%, kolor% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. kolor% New color for window printing.. Use WINCOLOR to set the color to use with subsequent calls to WINWRITE(), WINWRITECHAR(), and WINWRITELN(). ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 10 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SEE ALSO: ATTR, WINWRITE, WINWRITECHAR, WINWRITELN WinCopy% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Clones (duplicates) an open window. SYNTAX: varname% = WINCOPY (winHandle%) REMARKS: This function accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to duplicate. Use WINCOPY() to make an exact copy of an existing window. Every aspect is copied, including the contents of the window itself. RETURNS: This function returns the following value(s): Value Description ───── ─────────────────────────────────────────── 0 Could not duplicate. any The handle of the new window. SEE ALSO: WINOPEN, WINPOPUP WinDeleteLine - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Deletes and scrolls up one line in a window SYNTAX: WINDELETELINE winHandle%, LineNo% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. LineNo% Line number to delete. Use WINDELETELINE() to delete a single line in a window. All text below that line is scrolled up. SEE ALSO: WININSERTLINE WinDrawBox - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Tool to draw a box inside of a window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 11 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SYNTAX: WINDRAWBOX winHandle%, row%, col%, rows%, cols%, kolor%, border% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of an existing window. row% Row inside window to draw the box. col% Col inside window to draw the box. rows% Vertical dimension of box to draw. cols% Horizontal dimension of box to draw. kolor% Color to draw the box. border% Border style. Use WINDRAWBOX() to draw a box frame inside a window. The row% and col% arguments are relative to the inside of the window. SEE ALSO: WINFILL, WINPRINT WinFill - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Fills a portion of a window with a color/character. SYNTAX: WINFILL winHandle%, row%, col%, rows%, cols%, kolor%, char% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. row% Row inside window to fill. col% Col inside window to fill. rows% Vertical dimension of area to fill. cols% Horizontal dimension of area to fill. kolor% Color to use for fill. char% Character to use for fill. Use WINFILL() to fill an area within a window with the specified color and character. The row% and col% arguments are relative to the inside of the window. If a value of -1 is used for KOLOR%, the default window color is used. SEE ALSO: WINDRAWBOX WinGet - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Gets the handle of the top most window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 12 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SYNTAX: varname% = WINGET% REMARKS: Use WINGET% to get the handle of the top most window, or the handle of the window that was last affected during a call to GETEVENT(). SEE ALSO: GETEVENT WinGetCursor - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Returns current cursor position with a window. SYNTAX: WINGETCURSOR winHandle%, row%, col% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. row% Returns window cursor row. col% Returns window cursor column. Use WINGETCURSOR() to return the internal cursor position within a window. NOTE: PB/VISION does _not_ maintain a visible cursor for each window. SEE ALSO: WINLOCATE WinGetInfo - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Return complete information about an open window. SYNTAX: WINGETINFO winHandle%, win REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of an existing window. win A variable of type WINTYPE that holds complete information about the window. Use WINGETINFO() to return information about an open window. On return, the WIN argument, a variable of type WINTYPE, will hold the window information. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 13 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ WinHide - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Hides a displayed window. SYNTAX: WINHIDE winhandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. Use WINHIDE() to hide a displayed window. The window can be re-displayed via the WINSHOW() procedure. NOTE: If the %AUTOCLOSE flags was used when the window was opened, WINHIDE() will automatically call WINCLOSE() and the window will be nonrecoverable. SEE ALSO: WINCLOSE, WINOPEN, WINPOPUP, WINSHOW WinHotPrint - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Prints text to a window in two colors. SYNTAX: WINHOTPRINT winHandle%, row%, col%, kolor%, text$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. row% Window relative row to print text. col% Window relative column to print text. kolor% Extended color attribute of text. text$ Text to print. Use WINHOTPRINT() to print text to a window in two colors. Using an extended color code (read the tutorial) the default text is printed with the primary color code, and any text enclosed between two tilde characters (~) is printed with the secondary color code. Using a value of 0 for the COL% argument, the text will be centered on the line. SEE ALSO: WINPRINT EXAMPLE: WINHOTPRINT winHandle%, 2, 4, &H1F17, "Hello, ~World!~" ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 14 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ WinInsertLine - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Inserts and scrolls down one line in a window SYNTAX: WININSERTLINE winHandle%, LineNo% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. LineNo% Line number to insert. Use WININSERTLINE() to insert a single line in a window. All text below that line is scrolled down. SEE ALSO: WINDELETELINE WinInstallCode - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Assign code to a window for multitasking. SYNTAX: WININSTALLCODE winHandle%, segptr%, offptr% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. segptr% Segment address of procedure to task. offptr% Offset address of procedure to task. Use WININSTALLCODE() to assign a predefined function to the specified window. Whenever an event occurs that will effect that window, the given function is called with the handle and event number. SEE ALSO: WINOPEN, WINPOPUP, WINSHOW, TIMERINSTALLCODE WinLocate - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Relocate the cursor within window. SYNTAX: WINLOCATE winHandle%, row%, col% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 15 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ row% Window relative row to locate the cursor. col% Window relative column to locate the cursor. Use WINLOCATE() to reposition the internal cursor in a window. Subsequent calls to WINWRITE(), WINWRITECHAR(), or WINWRITELN() will print at this location. NOTE: PB/VISION does _not_ maintain a visible cursor for each window. SEE ALSO: WINWRITE, WINWRITECHAR, WINWRITELN WinLock - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Locks out access to all other windows. SYNTAX: WINLOCK winHandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to lock in place. Use WINLOCK() to lock out access to all other windows except the specified window. The lock remains active until WINLOCK 0 is called or the window is removed or hidden. The pulldown menu system and the status bar remain active. SEE ALSO: WINLOCKALL, WINSHOW WinLockAll - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Locks out access to all but the specified window. SYNTAX: WINLOCKALL winHandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to lock in place. Use WINLOCKALL() to lock out access everything but the specified window. The pulldown menu system and the status bar are also disabled. The lock remains active until WINLOCKALL 0 is called. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 16 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ NOTE: Closing of hiding the locked window does _not_ disable the lock. WINLOCKALL 0 must be called. SEE ALSO: WINLOCK, WINSHOW WinLockState% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Returns encoded info needed by WINLOCKRESTORE() SYNTAX: varname% = WINLOCKSTATE REMARKS: WINLOCKSTATE() returns an encoded value that is passed to WINLOCKRESTORE() upon termination of a modal window, menu, or data entry form. The information contained in the variable is the current state of WINLOCK() and WINLOCKALL(). This function should be called on entry to a modal window, menu, or data entry form routine. When exiting the routine, WINLOCKRESTORE() will re-instate any locks that were previously enabled. SEE ALSO: WINLOCK, WINLOCKALL, WINLOCKRESTORE WinLockRestore - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Restore the state of a locked window. SYNTAX: WINLOCKRESTORE varname% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── varname% Value returned by WINLOCKSTATE%() Use WINLOCKRESTORE() to return the window locking states that were present before the modal window, menu, or data entry form was displayed. SEE ALSO: WINLOCK, WINLOCKALL, WINLOCKSTATE WinMain - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Bring a window to the top of the screen. SYNTAX: WINMAIN winhandle% REMARKS: This procedure accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 17 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. Use WINMAIN() to quickly display an open window. If the window is already being displayed, it will be moved to the top of the window stack. SEE ALSO: WINOPEN, WINPOPUP, WINSHOW WinMaximize - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Maximizes a window to full size or full screen. SYNTAX: WINMAXIMIZE winhandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. Use WINMAXIMIZE() to re-size a window to its full virtual size. If the size is larger than the screen, the window is adjusted to fit within the confines of the screen. To return the window to its original size, use WINNORMALIZE(). If the window is re-sized with WINRESIZE() or with the mouse, the window is no longer considered maximized. SEE ALSO: WINMINIMIZE, WINNORMALIZE WinMinimize - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Minimizes a window to an icon. SYNTAX: WINMINIMIZE winhandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. Use WINMINIMIZE() to reduce a window to the smallest possible icon. All window controls are disabled and only a title is displayed. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 18 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ So that the window can be returned to normal via mouse control, it is recommended that you add one of the following two code fragments to your GETEVENT() loop: CASE 217 WINNORMALIZE WINGET or CASE 217 WINCTRLBOX WINGET To return the window to normal via software control, use WINNORMALIZE(). SEE ALSO: WINMAXIMIZE, WINNORMALIZE WinNormalize - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Returns a window to its previous dimensions. SYNTAX: WINNORMALIZE winhandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. Use WINNORMALIZE() to return a window to the state it was in before WINMINIMIZE() or WINMAXIMIZE() was called. The window will be returned to its previous position and size. SEE ALSO: WINMAXIMIZE, WINMINIMIZE WinModify - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Change physical attributes of an open window SYNTAX: WINMODIFY winHandle%, kolor%, border%, borderKolor%, TitleKolor%, flags% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. kolor% New color of window text. border% New border style (ranging 0 to 17). borderKolor% New color of window border. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 19 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ TitleKolor% New color of window title. flags% New window flags (see WINOPEN()). Use WINMODIFY() to change the visible attributes of a window, after it has already been opened. SEE ALSO: WINOPEN, WINPOPUP, WINSHOW WinMove - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Moves a window on the screen. SYNTAX: WINMOVE winHandle%, row%, col% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winhandle% Handle of a valid window. row% Vert. position to move the window to. col% Horiz. position to move the window to. Use WINMOVE() to move a window from one screen location to another. The window will maintain its relative position within the window stack. SEE ALSO: WINSHOW WinNext - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Brings forward the next logical window. SYNTAX: WINNEXT REMARKS: Use WINNEXT() to bring forward the next logical displayed window. SEE ALSO: WINPREV WinOpen% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Opens (creates) a new window. SYNTAX: winhandle% = WINOPEN% (rows%, cols%, kolor%, border%, borderKolor%, title$, titleColor%, flags%) REMARKS: This function accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 20 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ───────────── ──────────────────────────────────────── rows% Number of virtual rows in window. cols% Number of virtual columns in window. kolor% Color for window text. border% Border style for window. borderKolor% Color for window border. title$ Text to use as window title. TitleKolor% Color for window title. flags% Window display flags Use WINOPEN() to create a brand new virtual window. The ROWS% and COLS% arguments refer to the "virtual" size, not the displayed size. In PB/VISION(tm), window can be larger than what is displayed. The FLAGS% argument controls various display features for the window and is built by logically OR'ing constants defined in WINDOW.BI. The %NOCOLOR flag is of specific interest because it will reduce the memory requirements for that particular window by 50%. All text in that window will be displayed in the default window color. Constant Description ───────────── ──────────────────────────────────────── %AUTOCLOSE Forces window to close if it becomes hidden. %AUTOSCROLL Coordinates window scroll relative to window viewport and allows mouse and keyboard scrolling of window. %BOTTOMBAR Adds an attractive bottom bar to graphical windows that do not already have one. %CONTROL Add a control box icon to the window (See WINCTRLBOX(). %DRAGBAR Add a drag bar to the window. %HSCROLLBAR Add a horizontal scroll bar to the window. %MINMAX Add minimize and maximize icons to the window. %NOHORZBORDER Remove horizontal border from window. %NOCOLOR Defines that all text in the window is of one color (saves 50% memory). %NOHIDE Does not allow window to be hidden. %NOSELECT Disables all mouse manipulation of a window. %NOVERTBORDER Remove vertical border from window. %RESIZE Add a resize icon to the window. %SHADOW Add a shadow to the window (lower/right) %VSCROLLBAR Add a vertical scroll bar to the window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 21 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ RETURNS: WINOPEN%() returns a valid window handle, or 0 on error. You will need to keep track of this handle for later manipulation of the window. SEE ALSO: WINCLOSE, WINPOPUP, WINSHOW, WININSTALLCODE WinPopup% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Opens (creates) a new window and displays it. SYNTAX: winhandle% = WINPOPUP% (row%, col%, rows%, cols%, kolor%, border%, borderKolor%, title$, titleKolor%, flags%) REMARKS: This function accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── row% Vert. position to display the window. col% Horiz. position to display the window. rows% Number of virtual rows in window. cols% Number of virtual columns in window. kolor% Color for window text. border% Border style for window. borderKolor% Color for window border. title$ Text to use as window title. TitleKolor% Color for window title. flags% Window display flags Use WINPOPUP() to create and display a brand new virtual window. The ROWS% and COLS% arguments refer to the both the "virtual" size _and_ the displayed size. If a value of 0 is used for the ROW% and/or COL% arguments, the window will auto-center in that plane. This function is simply a faster way to create and display a window. RETURNS: WINPOPUP%() returns a valid window handle, or 0 on error. You will need to keep track of this handle for later manipulation of the window. SEE ALSO: WINCLOSE, WINOPEN, WININSTALLCODE WinPrev - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Brings forward the last logical window. SYNTAX: WINPREV ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 22 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ REMARKS: Use WINPREV() to bring forward the last logical displayed window. SEE ALSO: WINNEXT WinPrint - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Print text in an open window. SYNTAX: WINPRINT winHandle%, row%, col%, kolor%, text$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. row% Window relative row to print text. col% Window relative column to print text. Kolor% Color of text to print. text$ Text to print. Use WINPRINT() to print text to a window in the color specified in the KOLOR% argument. If a value of -1 is used, the text is printed in the default window color. Using a value of 0 for the COL% argument, the text will be centered on the line. SEE ALSO: WINHOTPRINT, WINWRITE, WINWRITECHAR, WINWRITELN WinReColor - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Changes color of window and all text within. SYNTAX: WINRECOLOR winHandle%, kolor% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of a valid window. kolor% New color for window and text. Use WINCOLOR to change the color of an open window and re-color all of the text in that window. SEE ALSO: ATTR WinRefresh - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Forces a re-display on an open window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 23 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SYNTAX: WINREFRESH winHandle% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of the window to refresh. Use WINREFRESH() to update a window when automatic window refreshing has been disabled with WINREFRESHMODE(). A side-effect of this call is that all windows on top of the window to be refreshed will also be refreshed. SEE ALSO: WINREFRESHMODE WinRefreshMode - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Enables or disables screen refreshing. SYNTAX: WINREFRESHMODE mode% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── mode% 0 disables refreshing, 1 re-enables. Use WINREFRESHMODE() to enable or disable automatic screen refreshing of all displayed windows. When disabled, all printing to a window does not cause an immediate update. Use WINREFRESH() for this purpose. SEE ALSO: WINREFRESH, WINPRINT WInResize - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Changes the displayed size of a window. SYNTAX: WINRESIZE winHandle%, rows%, cols% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of the window to re-size. rows% New vertical dimension of window. cols% New horizontal dimension of window. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 24 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Use WINRESIZE() to change the displayed size of an open window. The "virtual" size is not affected. SEE ALSO: WINOPEN, WINPOPUP WinScrollBarGet - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Returns the position of scroll pointers in a window. SYNTAX: WINSCROLLBARGET winHandle%, vpos%, hpos% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of the window to adjust. vpos% Vertical scroll bar position (1-100). hpos% Horizontal scroll bar position (1-100). Use WINSCROLLBARGET() to return the position of the horizontal and vertical scroll bars in a displayed window. Window scroll bars positions are measured in percentages of 100. If a window is re-sized, the position indicator will be updated to reflect the percentage. SEE ALSO: WINSCROLLBARSET WinScrollBarSet - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Changes position of scroll bar pointers in a window. SYNTAX: WINSCROLLBARSET winHandle%, vpos%, hpos% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of the window to adjust. vpos% Vertical scroll bar position (1-100). hpos% Horizontal scroll bar position (1-100). Use WINSCROLLBARSET() to change the position of the horizontal and vertical scroll bars on a displayed window. Window scroll bars positions are measured in percentages of 100. If a window is re-sized, the position indicator will be updated to reflect the percentage. Using a value of -1 for either scroll bar will leave the position as it is. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 25 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SEE ALSO: WINSCROLLBARGET WinShow - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Displays a window. SYNTAX: WINSHOW winHandle%, row%, col%, rows%, cols% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to display row% Vert. position to display the window. col% Horiz. position to display the window. rows% Number of window rows to display cols% Number of window columns to display. Use WINSHOW() to place an open window on the screen. If the window is already being displayed, it will be brought to the top of the window stack. If a value of 0 is used for the ROW% and/or COL% arguments, the window will auto-center in that plane. Using 25 and 80 for the ROWS% and COLS%, respectively, will relive you of having to keep track of their actual size as windows can never be displayed in a size larger that their virtual size. SEE ALSO: WINOPEN WinSwapColor - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Swaps all occurrences one color with another in a window. SYNTAX: WINSWAPCOLOR winHandle%, oldColor%, newColor% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to change. oldColor% Color to change. newColor% Color to change to. Use WINSWAPCOLOR() to change all occurrences of one color in a window to another color. SEE ALSO: WINRECOLOR ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 26 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ WinViewPort - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Changes the view within a window. SYNTAX: WINVIEWPORT winHandle%, row%, col% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to change view row% Virtual row to begin view at. col% Virtual column to begin view at. Use WINVIEWPORT() to change the displayed contents of a window. Remember, in PB/VISION, windows can be larger than the displayed portion. This function provides the means to indicate what part of the window you want to start looking at. SEE ALSO: WINSHOW WinWrite - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Writes text to an open window. SYNTAX: WINWRITE winHandle%, text$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to write you. text$ Text to write. Use WINWRITE() to write text to a window at the current internal window cursor position. Text is always printed using the last color specified by the last call to WINCOLOR(). SEE ALSO: WINPRINT, WINWRITECHAR, WINWRITELN WinWriteChar - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Writes a character to an open window. SYNTAX: WINWRITECHAR winHandle%, char% REMARKS: This procedure accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 27 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to write you. char% ASCII character to write. Use WINWRITECHAR() to write an ASCII character to a window at the current internal window cursor position. The character is always printed using the last color specified by the last call to WINCOLOR(). SEE ALSO: WINPRINT, WINWRITE, WINWRITELN WinWriteLn - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Writes text and linefeed to an open window. SYNTAX: WINWRITELN winHandle%, text$ REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── winHandle% Handle of window to write to. text$ Text to write. Use WINWRITELN() to write text to a window at the current internal window cursor position and then advance the cursor to the beginning of the next line. When the cursor reaches the last line, the window is scrolled up. Text is always printed using the last color specified by the last call to WINCOLOR(). SEE ALSO: WINPRINT, WINWRITE, WINWRITECHAR ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 28 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Chapter 2 EVENT MANAGEMENT ROUTINES █████████████████████████████████████████████████████████████████ GetEvent% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Command dispatcher/monitor for keyboard/mouse events. SYNTAX: varname% = GETEVENT%(cmd%) REMARKS: Use GETEVENT%() to add event-driven processing to a PB/VISION(tm) application. GETEVENT%() takes control of the application for 1 clock tick (.055 seconds) and processes any pending keystrokes or mouse clicks. When an event occurs, the appropriate processing routines are automatically invoked. Upon completion, GETEVENT%() returns a unique code (see below) indicating the type of event that occurred. This function accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── cmd% Use '0' for this version. RETURNS: This function returns the following value(s): The following event codes are returned when a key has been pressed and it cannot be processed by any displayed objects. Use KEYGET%() to retrieve the keystroke. Value Description ───── ──────────────────────────────────────────────── 100 A key was pressed. (Use KEYGET%() to retrieve.) 101 <CR> was pressed. 102 <ESC> was pressed. 103 <F1> was pressed. 104 <TAB> was pressed. 105 <SHIFT-TAB> was pressed. 106 <ALT-TAB> was pressed. 107 <CTRL-TAB> was pressed. 108 <ALT-SPACE> was pressed. 111 <UP> cursor key was pressed. 112 <DN> cursor key was pressed. 113 <LEFT> cursor key was pressed. 114 <RIGHT> cursor key was pressed. 115 <PGUP> cursor key was pressed. 116 <PGDN> cursor key was pressed. 117 <HOME> cursor key was pressed. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 29 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 118 <END> cursor key was pressed. 119 <INS> cursor key was pressed. 120 <DEL> cursor key was pressed. 121 <CTRL-PGUP> was pressed. 122 <CTRL-PGDN> was pressed. 123 <CTRL-HOME> was pressed. 124 <CTRL-END> was pressed. 125 <CTRL-INS> was pressed. 126 <CTRL-DEL> was pressed. 127 <CTRL-LEFT> was pressed. 128 <CTRL-RIGHT> was pressed. 129 <SHIFT-INS> was pressed. The following event codes are returned when a displayed window is manipulated with the mouse. Use WINGET%() to retrieve the handle of the window manipulated. Value Description ───── ──────────────────────────────────────────────── 200 Window GOTFOCUS event. 201 Window LOSTFOCUS event. 202 Window CLICK event. 203 Window CONTROLBOX event. 204 Window MINIMIZE event. 205 Window MAXIMIZE event. 206 Window MOVE event. 207 Window RESIZE event. 208 Window VERTICAL SCROLL PAD event. 209 Window VERTICAL SCROLL UP event. 210 Window VERTICAL SCROLL DN event. 211 Window HORIZONTAL SCROLL PAD event. 212 Window HORIZONTAL SCROLL LEFT event. 213 Window HORIZONTAL SCROLL RIGHT event. 214 Window CLOSE event. 215 Window HIDE event. 216 Window NOCLICK event. 217 Window clicked while minimized. 218 Window NORMALIZE event. 219 Window viewport was changed. 250 Right mouse button clicked. SEE ALSO: WINGET HotKeyAdd - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Defines a custom user "hot key" SYNTAX: HOTKEYADD scancode%, eventNo% REMARKS: This procedure accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 30 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ──────────── ──────────────────────────────────────── scancode% Keyboard scan code to use as accelerator. eventNo% Custom event code to return to GetEvent(). Use HOTKEYADD() to define a custom "hot key" event. When the keyboard scan code is received, the custom event number will be returned to GetEvent() or will be passed to your installed window process. SEE ALSO: HOTKEYTOGGLE HotKeyToggle - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Toggle the state of an individual hot key. SYNTAX: HOTKEYTOGGLE scancode%, mode% REMARKS: This procedure accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── scancode% Keyboard scan code to use as accelerator. mode% Initial mode (0=disabled, 1=enabled) Use HOTKEYTOGGLE() to change the state of a hot key entry. SEE ALSO: HOTKEYADD TimerInstallCode - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Install a background task. SYNTAX: TIMERINSTALLCODE segptr%, offptr% REMARKS: This procedure accepts the following argument(s): Argument Description ───────────── ──────────────────────────────────────── segptr% Segment address of function to task. offptr% Offset address of function to task. Use TIMERINSTALLCODE() to assign a background timer task. The assigned routine will be called up to 18 times per second so it should not tie up system resources for excessive periods. The routine should resemble: FUNCTION YourRoutine% (BYVAL UpdateSafe%) ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 31 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ YourRoutine% = SomeEventCode END FUNCTION When the assigned routine is called it is passed an integer value of 0 or 1 (in the UPDATESAFE% parameter) Only when 1 is passed is it safe to update the screen. Since the routine you assign is a function, it can return an event code back to the GETEVENT() routine if desired. Again, the event code can only be returned when the UPDATESAFE% parameter is 1. To remove the routine, pass 0 for both the SEGPTR% and OFFPTR% parameter NOTE: Possible uses for this routine include creating a background file printing routine, a "watch dog" for the serial port, scrolling banner handler, etc. SEE ALSO: WININSTALLCODE WinCtrlBox - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Displays a "control box" over an window. SYNTAX: WINCTRLBOX winHandle% REMARKS: This procedure accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── winHandle% Handle of displayed window. menucolor Variable of type MENUCOLORTYPE that defines the displayed attributes of the control box window. Use WINCTRLBOX() to display a window "control box". The control box allows the user to close, move, re- size, minimize, or maximize the window it is assigned to. SEE ALSO: HOTKEYADD ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 32 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Chapter 3 MOUSE ROUTINES █████████████████████████████████████████████████████████████████ Mouse% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Returns mouse button/position information. SYNTAX: varname% = MOUSE%(button%, cmd%) REMARKS: This function accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── button% Button to read. Value Description ───── ────────────────────────────── 1 Left mouse button. 2 Right mouse button. 4 Middle mouse button. cmd% Mouse button property to read. Value Description ───── ────────────────────────────── 1 Is button currently pressed. 2 Button clicks since last call. 3 Current mouse cursor row. 4 Current mouse cursor column. 5 Last mouse press row. 6 Last mouse press column. 7 Last mouse release row. 8 Last mouse release column. 9 Has the mouse status changed. Use MOUSE%() to return specific properties of a given mouse button. Command number 1 returns a positive value if the mouse is currently pressed. Command 2 can then returns the number of times the button was pressed. Command 9 returns a positive value if the mouse is pressed and if it has been moved since the last call to command 9. SEE ALSO: MOUSEINIT ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 33 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ MouseCursorOff - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Turns the mouse cursor off. SYNTAX: MOUSECURSOROFF REMARKS: Use MOUSECURSOROFF() to turn off the mouse cursor. For each call to MOUSECURSOROFF(), an equal number of calls to MOUSECURSORON() must be made. SEE ALSO: MOUSECURSORON, MOUSETERM MouseCursorOn - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Turns the mouse cursor on. SYNTAX: MOUSECURSORON REMARKS: Use MOUSECURSORON() to turn the mouse on after a call to MOUSEINIT() or a call to MOUSECURSOROFF(). SEE ALSO: MOUSECURSOROFF, MOUSEINIT MouseGet% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Retrieves the current position of the mouse. SYNTAX: varname = MOUSEGET%(row%, col%) REMARKS: This function accepts the following argument(s): Argument Description ─────────── ───────────────────────────────────────── row% Current screen row is returned in here. col% Current screen column is returned in here. Use MOUSEGET() to retrieve the current position of the mouse cursor. If any mouse buttons are pressed, MOUSEGET() will also return the button value. RETURNS: This function returns the following value(s): Value Description ───── ──────────────────────────────────────────────── 0 No buttons are currently pressed. 1 The left mouse button is currently pressed. 2 The right mouse button is currently pressed. 4 The middle mouse button is currently pressed. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 34 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ SEE ALSO: MOUSESET MouseGetInfo - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Retrieve information about the mouse. SYNTAX: MOUSEGETINFO major%, minor%, irq%, mtype% REMARKS: This procedure accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── major% Mouse driver major version number. minor% Mouse driver minor version number. irq% IRQ number mouse is installed on. Value Description ───── ────────────────────────────── 0 PS/2 pointing device. 1 not defined. 2 IRQ2. 3 IRQ3. ... ... 7 IRQ7. mtype% Type of mouse installed. Value Description ───── ────────────────────────────── 1 bus mouse. 2 serial mouse. 3 Microsoft InPort. 4 IBM PS/2 Pointing Device port. 5 Hewlett-Packard mouse. Use MOUSEGETINFO() to retrieve complete information on an installed mouse and mouse driver. SEE ALSO: MOUSEINIT MouseGetPress% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Retrieves position of last mouse press. SYNTAX: varname = MOUSEGETPRESS%(button%, presses%, row%, col%) REMARKS: This function accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 35 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ──────────── ───────────────────────────────────────── button% Button to select. Value Description ───── ────────────────────────────── 1 Left mouse button. 2 Right mouse button. 4 Middle mouse button. presses% Number of presses since last call. row% Screen row of last button press. col% Screen column of last button press. Use MOUSEGETPRESS%() to retrieve the number of mouse presses since the last call to this same function. The ROW% and COL% will hold the position of the very last mouse press. RETURNS: This function returns the following value(s): Value Description ───── ──────────────────────────────────────────────── 0 No buttons are currently pressed. 1 The left mouse button is currently pressed. 2 The right mouse button is currently pressed. 4 The middle mouse button is currently pressed. SEE ALSO: MOUSEGET, MOUSEGETRELEASE MouseGetRelease% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Retrieves position of last mouse release. SYNTAX: varname = MOUSEGETRELEASE%(button%, releases%, row%, col%) REMARKS: This function accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── button% Button to select. Value Description ───── ────────────────────────────── 1 Left mouse button. 2 Right mouse button. 4 Middle mouse button. releases% Number of releases since last call. row% Screen row of last button releases. col% Screen column of last button releases. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 36 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Use MOUSEGETRELEASE%() to retrieve the number of mouse releases since the last call to this same function. The ROW% and COL% will hold the position of the very last mouse release. RETURNS: This function returns the following value(s): Value Description ───── ──────────────────────────────────────────────── 0 No buttons are currently pressed. 1 The left mouse button is currently pressed. 2 The right mouse button is currently pressed. 4 The middle mouse button is currently pressed. SEE ALSO: MOUSEGET, MOUSEGETPRESS MouseInit% - FUNCTION ───────────────────────────────────────────────────────────────── PURPOSE: Initializes the mouse and returns button count. SYNTAX: varname = MOUSEINIT%(buttons%) REMARKS: This function accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── buttons% Number of mouse buttons is returned here. Use MOUSEINIT%() to initialize the mouse under PB/VISION. If a mouse is detected, the BUTTONS% parameter will hold the number of mouse buttons available. To display the mouse, MOUSECURSORON() must also be called. To set the mouse cursor style (text or graphics), see APP.GRAPHICSMOUSE. RETURNS: Returns 0 if a mouse is not available. Any other value indicates a mouse is present. SEE ALSO: APP, MOUSECURSORON, MOUSETERM MouseSet - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Moves the mouse to a specific screen location. SYNTAX: MOUSESET row%, col% REMARKS: This procedure accepts the following argument(s): ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 37 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Argument Description ──────────── ───────────────────────────────────────── row% Screen row to move cursor to. col% Screen column to move cursor to. Use MOUSESET() to relocate the mouse cursor to a new screen location. SEE ALSO: MOUSEGET MouseSetWindow - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Locks mouse within given screen boundaries. SYNTAX: MOUSESETWINDOW row%, col%, rows%, cols% REMARKS: This procedure accepts the following argument(s): Argument Description ──────────── ───────────────────────────────────────── row% First row of mouse window col% First column of mouse window. rows% Vertical dimension of mouse window. cols% Horizontal dimension of mouse window. Use MOUSESETWINDOW() to lock the mouse within a given location on the screen. The cursor will not be permitted to move out of this area. To remove the window, use the following code: MOUSESETWINDOW 1, 1, pbvScrnRows, pbvScrnCols SEE ALSO: MOUSESET MouseTerm - PROCEDURE ───────────────────────────────────────────────────────────────── PURPOSE: Terminates mouse operation. SYNTAX: MOUSETERM REMARKS: Use MOUSETERM() to terminate mouse operation. This procedure should be called prior to the use of any of the following PowerBASIC statements: END CHAIN SLEEP SEE ALSO: MOUSECURSOROFF, MOUSEINIT ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 38 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Chapter 4 DATA TYPES USED █████████████████████████████████████████████████████████████████ MENUCOLORTYPE - TYPE ───────────────────────────────────────────────────────────────── PURPOSE: Menu and List definition TYPE. REMARKS: This TYPE has the following element(s): Element Description ───────────── ──────────────────────────────────────── kolor% Color of menu/list text. borderKolor% Color of menu/list border. titleKolor% Color of menu/list title. highlight% Color of menu/list highlight bar. sepbar% Color of menu/list separator line. cursor% UNUSED border% Border style for window. flags% Help window display flags Use the MENUCOLORTYPE type to define how menus and lists will look when displayed. SEE ALSO: WINCTRLBOX WINTYPE - TYPE ───────────────────────────────────────────────────────────────── PURPOSE: Window definition TYPE. REMARKS: This TYPE has the following element(s): Element Description ───────────── ──────────────────────────────────────── row Screen position where window is displayed. col rows Dimensions of the displayed text portion of window. cols orows Window text dimensions before re-sizing. ocols vrow Starting positions of viewport into window. vcol vrows Actual virtual dimensions of window. vcols winattr Default color attribute of window contents. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 39 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ borderattr Attribute of window border. titleattr Attribute of window title. border Border style. titleLen Length of title string. Title$ Text of window title. vbarPos Window scroll bar gauge (1% to 100%). hbarPos flags Flags used when window opened. winmode INTERNAL - DO NOT CHANGE. UserObject User Object Pointer. unused2 FUTURE USE. WI Relative window index. ObjPtr Handle of attached window object code. internal1 INTERNAL - DO NOT CHANGE. signature Signature of window. cpos Encoded window cursor position (see WINLOCATE). cattr Current window print attribute (see WINCOLOR). bufferHandle Handle of window buffer. changed Flag indicating window needs to be refreshed. unused3 FUTURE USE. listPtr Top of list (if list style routine). winCodePrt Pointer to window driver. winUserPtr Pointer to WININSTALLCODE() routine. srows Screen dimensions of the displayed window. scols Use the WINTYPE type to define how windows will look when displayed. SEE ALSO: WINOPEN, WINPOPUP, WINGETINFO ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 40 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Index %AUTOCLOSE 21 H %AUTOSCROLL 21 HotKeyAdd 30 %BOTTOMBAR 21 HotKeyToggle 31 %CONTROL 21 %DRAGBAR 21 M %HSCROLLBAR 21 MapChar 8 %MENUBAR 5 MapUserChar 9 %MINMAX 21 MENUCOLORTYPE 39 %NOCOLOR 21 Mouse 33 %NOHIDE 21 MouseCursorOff 33 %NOHORZBORDER 21 MouseCursorOn 34 %NOSELECT 21 MouseGet 34 %NOVERTBORDER 21 MouseGetInfo 35 %RESIZE 21 MouseGetPress 35 %SHADOW 21 MouseGetRelease 36 %STATUSBAR 5 MouseInit 37 %VSCROLLBAR 21 MouseSet 37 MouseSetWindow 38 A MouseTerm 38 App 5 App.attr 5 T App.flags 5 TimerInstallCode 31 App.graphicsMode 5 App.graphicsMouse 5 W App.menuAttr 5 WinClose 9 App.Pattern 5 WinCls 10 App.rows 5 WinColor 10 App.snow 5 WinCopy% 11 App.statusAttr 5 WinCtrlBox 32 App.title 5 WinDeleteLine 11 App.titleAttr 5 WinDrawBox 11 AppClose 5 WinFill 12 AppFontInit 6 WinGet 12 AppInit 6 WinGetCursor 13 AppPause 6 WinGetInfo 13 AppRefresh 7 WinHide 14 AppResume 7 WinHotPrint 14 AppTitle 7 WinInsertLine 15 Attr% 8 WinInstallCode 15 WinLocate 15 G WinLock 16 GetEvent 29 WinLockAll 16 WinLockRestore 17 WinLockState% 17 ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 41 PB/VISION(tm) LITE - Version 1.10 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ WinMain 17 WinRefreshMode 24 WinMaximize 18 WInResize 24 WinMinimize 18 WinScrollBarGet 25 WinModify 19 WinScrollBarSet 25 WinMove 20 WinShow 26 WinNext 20 WinSwapColor 26 WinNormalize 19 WinTitle 9 WinOpen% 20 WINTYPE 39 WinPopup% 22 WinViewPort 27 WinPrev 22 WinWrite 27 WinPrint 23 WinWriteChar 27 WinReColor 23 WinWriteLn 28 WinRefresh 23 ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (c) Copyright 1993-94 DSE Software Publishing 42 ORDER FORM FOR ALL PRODUCTS FROM DSE SOFTWARE PUBLISHING ----------------------------------------------------------------------- YOU CAN FAX US OR ORDER ONLINE BY CALLING OUR FAX/BBS AT (707) 459-4484 TO: FROM: DSE SOFTWARE PUBLISHING ________________________________________ POST OFFICE BOX 96 Name WILLITS, CA 95490-0096 ________________________________________ USA Company (ONLY if ordering for a company) ________________________________________ Voice: (707) 459-4358 Address FAX/BBS: (707) 459-4484 ______________________ _____ _________ City State Zip GEnie: "DSE.SOFTWARE" ______________________ ________________ FidoNet: 1:125/123 Phone Fax Internet: dse@pacific.net dse.software@genie.geis.com ================= P R O D U C T S R E Q U E S T E D ================ ORDER DESCRIPTION PRICE QTY EXTENDED ------- -------------------------------------- ----- --- -------- 20810 PB/VISION(tm) LITE 25.00 ___ ________ 20812 PB/VISION(tm) PRO w/ manual on disk 79.00 ___ ________ +> 20813 PB/VISION(tm) PRO w/ printed manual 99.00 ___ ________ | 20510 MUSIC CD TOOLKIT for PowerBASIC 3.x 19.95 ___ ________ | 20615 dseINSTALL(tm) Software Install Util. 19.95 ___ ________ | | Shipping, Handling, and Fees (Indicate Below) ............. ________ | Sales Tax (CA. Residents add 7.25%) ....................... ________ | Total Order (United States Funds ($US FUNDS) Only) ........ ________ | | DISK SIZE SHIPPING/HANDLING/FEES SHIPPING NOTES | --------- ------------------------- -------------------------------- | [X] 3.50" [_] USA $ 5.50 USA / SHIPPED PRIORITY MAIL | ONLY [_] CANADA $ 5.50 VISA/MC/POSTAL MONEY ORDER ($US) | [_] OVERSEAS $10.00 SEE "TERMS OF SALE" (below) +-----------> [_] OVERSEAS $20.00 OVERSEAS WITH PRINTED MANUAL ========================== CREDIT CARD ORDERS ======================== [ ] VISA -> TOTAL ORDER : $_________ <- enter total order here [ ] MASTERCARD -> CARD HOLDER : ____________________________________ -> CARD NUMBER : ____________________________________ EACH LINE MUST ---> EXPIRATION : ___ / ___ BE FILLED IN ---> SIGNATURE : ____________________________________ ============================ TERMS OF SALE =========================== o All checks must be drawn on a United States bank and in $US funds. o Purchase Orders: Please call for authorization. o Returned check fee: $300 (for insufficient funds. [DSE-1094]